Scenario Studio Interface

Scenario Studio is a two-column workspace. The left column holds the Command Sequence panel; the right column holds the editor toolbar and editor panels.

For narrative on how to build and run a sequence, see Command Sequence. For panel-by-panel field guidance, see Scenario Editor.

Layout

Command Sequence

Header with the section title and a live count of Running, Queued and Completed items. Body renders up to three groupings — Running Sequence, Queued (with a Clear button and a Requeue option for each item in Completed), Completed — and shows a "No commands yet" empty state when all three are empty. Footer carries a + Add command button that opens the template picker.

The Command Sequence panel header also has two buttons:

• Check data — opens the Data Readiness dialog without starting a run.
• Outputs (desktop only) — opens the Scenario Outputs dialog showing folders on disk with size, last run date, and current sequence use.

Right-clicking a sequence line opens a context menu with the following options:

• Compare settings with — side-by-side comparison of two sequence lines.
• New comparison set — build a set of lines for running and comparing results.
• Notes — add or edit a short description kept with a sequence item.
• Duplicate with a change — copies the line with one setting changed; the new line is inserted directly after the original.
• Change setting on selected lines — sets one setting to the same value on every selected line (Ctrl/Shift+click to select multiple).

Tab Strip

A horizontal tab strip runs along the top of the right column, visible at all times. The strip has nine tabs in three groups:

• Scenario: Scenario Settings
• Inputs and Simulation Options: Input Files, Bids, Scaling Options, Simulation Rules
• Advanced Simulation Options: Optimization, Market Modelling, Diagnostics, Demand Forecasting

Click a tab to open the corresponding editor panel.

Main Bar

A toolbar above the tab strip contains four buttons, in order:

• Default output — sets the default output format for new scenarios. Dropdown: csvout, default, noIsdbResults.
• Directory Initializer — opens the Directory Initializer wizard.
• Save as Template — opens the Save as Template dialog.
• Run Log — toggles the Run Log panel; live badge counters (▶ running, ✓ successful, ✗ failed).

Settings Search

A search field at the top of the editor area searches across all editor panel fields. When a search is active, the tab strip shows only panels with matching fields, with a count badge on each tab.

Editor Content

Two stacked pieces, top to bottom:

1. Panel header — scenario ID and a type badge (Simulation, Historical, Recalc, Base, Backcast).
2. Panel body — the currently selected editor panel (see Editor panels below).

Empty State

The right column shows a "No command selected — Select a command from the sequence, or add one to start configuring." empty state when no sequence item is active.

Dialogs

These are not part of the grid — they overlay it when open, then dismiss:

• Template Picker Modal — opened by + Add command in the Command Sequence or by the Load button. Presents default, custom and Edit-Scenario templates.
• Save as Template dialog — opened by the Save as Template button in the main bar (see also Scenario Template).
• Working-folder mismatch confirmation — appears when the sequence item's scenario directory differs from the app's currently-configured working folder. Choosing Yes opens the Directory Initializer wizard; No dismisses the pair for the session.
• Close open scenarios — appears when running would overwrite scenarios currently open in the Dashboard. Title: Close open scenarios. Message: "These scenarios are open in the Dashboard and must be closed before they can be overwritten:" followed by a list of scenario names. Buttons: Close them and run / Cancel.
• Overwrite warning — appears when running would overwrite existing output. Button: Overwrite and run confirms the run; Cancel dismisses.
• Change setting on selected lines — opened by right-clicking a Queued line when one or more lines are selected (Ctrl/Shift+click). Title: "Change setting on selected lines". Sets one setting to the same value on every selected line; a search field narrows the setting list and a preview shows what each line will change to before confirming.
• Duplicate with a change — opened by right-clicking a sequence line and choosing "Duplicate with a change". Copies the line with one setting changed; the new line is inserted directly after the original.

Action Bar

One row spanning the full page width, split into a left group and a right group. In on-screen order:

Save and Load

Button	Behaviour	Enabled when
Load ▾	Opens a dropdown. Load file imports a batch file into the Command Sequence (see Load ▾ options below). Convert old batch file opens the conversion modal for a legacy .bat file.	Always.
Save	Opens the save dialog on the Command Sequence panel.	At least one item exists in Queued OR Completed. Running-only sequences cannot be saved.

Load ▾ options

Load file

Load ▾ → Load file parses a batch file and opens the Batch file preview dialog before importing. The dialog has two views: Summary and Batch file:

• Summary view — a row of tags (one per matched scenario or problem class) and up to three flagged sections:
  • Needs attention — Missing base lists scenarios that open a base not present in the sequence (their run would fail); Unknown flags lists flags the Suite cannot recognise and blocks the import until corrected.
  • Scenarios ready to create are shown separately.
• Batch file view — the raw batch text with line numbers.

Multiple Files

Load ▾ → Load several batch files — pick multiple .bat or .cmd files at once.

Paste batch text

Load ▾ → Paste batch text — type or paste batch file content directly.

Convert old batch file

Load ▾ → Convert old batch file opens the Convert old batch file dialog. One tag row at the top summarises what needs changing (one tag per rule). Two view tabs switch the body:

• Changes (default) — changes grouped by rule. Each item shows the line number, a status badge, and the before/after diff. Click a line number to jump to that line in the Side by side view.
• Side by side — the Original file on the left and the Converted file on the right, aligned row-for-row. A navigation bar provides ↑ Previous change and Next change ↓ buttons, a Show only changed lines (with 2 lines around) toggle, and per-rule on/off checkboxes to exclude individual rules.

When multiple files are passed, a file-tab row appears above the body.

The dialog also has an Also convert the .bid and .mdb files it uses checkbox. When ticked, any .bid bid files and .mdb databases named in the batch file are converted to .bidx and .db format respectively, placed beside the originals. This is the UI equivalent of the --convert-files command-line flag.

Footer controls:

• Save converted — writes <name>_converted.bat (and report) without loading.
• Convert and load — saves and immediately loads the converted file into the Command Sequence.
• Cancel — closes without saving.

Tools and Run

Button	Behaviour	Enabled when
Directory Initializer	Opens the Settings Initializer wizard (the GUI counterpart to Defaults.csv / DefInit.bat — see Directory and Databases Initializer).	Always.
Run Sequence	Executes the current sequence. Label changes to "Running…" during execution.	See gating rules below.
Run Log	Toggles the Run Log panel. Carries live badge counters — ▶ running, ✓ successful, ✗ failed — pulled from the current run history.	Always.

Run Disabled

Run Sequence is disabled when ANY of the following is true (union OR):

1. There are no items in the current sequence (Running + Queued both empty).
2. There is a coverage warning — input-file coverage across the sequence's date range is incomplete.
3. There is a file resolution mismatch — one or more items reference a demand or generation file whose interval resolution does not match the scenario.
4. A sequence is already running.

The tooltip on the disabled button reflects the first-true condition, in this priority order: already-running → resolution mismatch → previous bid generation failed (retry hint) → coverage-warning text → the fallback "Run the full command sequence".

Editor Panels

Clicking a tab in the horizontal strip at the top of the editor area opens the corresponding panel. All nine are listed here for reference; the full field-by-field guide for each panel lives on the Scenario Editor page.

Tab	Panel	Notes
Scenario Settings	Scenario Options	Type selector surfaces contextual hints; DB / JSON toggle switches the database selector.
Input Files	Input Options
Bids	Bid Options	Bid Loading Method dropdown with three modes (auto / custom / bidset) plus a Retain Loaded Bids checkbox.
Scaling Options	Panel Scaling Options
Simulation Rules	Panel Simulation Rules	Houses the fields formerly on the retired parameters tab — Static Loss Factor, Ramp Limit, Energy Limits, Forced Minimum Load and similar. An Object Filters collapsible group is at the top.
Optimization	Panel Optimization
Market Modelling	Panel Market Modelling	Set of collapsible cards; each card has its own header chevron.
Diagnostics	Panel Diagnostics	Set of collapsible cards; each card has its own header chevron.
Demand Forecasting	Demand Forecasting	iLoad Mode selector (Disabled / Analyze / Forecast / ReForecast / Compare) gates every other control on the panel — the rest of the panel is hidden until an active mode is chosen.

Notable in-panel switches, called out for orientation (details on the Scenario Editor page):

• Bids — a Bid Loading Method dropdown with three modes: auto (Historical Bid Loading), custom (Custom Bid Loading), bidset (Bid Set File). A Retain Loaded Bids checkbox sits alongside.
• Demand Forecasting — an iLoad Mode selector (Disabled / Analyze / Forecast / ReForecast / Compare) gates every other control on the panel: the rest of the panel is hidden until an active mode is chosen.
• Simulation Rules — carries an Object Filters collapsible group at the top.
• Market Modelling and Diagnostics — each panel is a set of collapsible cards; every card has its own header chevron.